home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / comm / msged400.zip / readme.txt < prev    next >
Text File  |  1996-08-10  |  13KB  |  347 lines
  1.                MSGED 4.00   released 1996-08-10
  2.  
  3.             
  4. NOTE!  Before contacting me for support, please make sure you are 
  5. using the latest archive produced by *me*.  If you use another
  6. version of MSGED, contact the author of that for support, even
  7. if the problem also occurs in my version, as that is only fair, and
  8. helps spread the workload.  Plus the fact that even if I do fix it,
  9. you're not going to be using my fixed version anyway, so there is
  10. little point in reporting it to me.  I am busy enough as it is, and
  11. have many other PD projects to work on.
  12.  
  13.  
  14.                      
  15. INTRODUCTION               
  16.  
  17. This archive is a message editor that works under 16-bit DOS,
  18. 32-bit OS/2, and has more limited versions for Amigados and
  19. Linux as well.  It works with *.MSG messagebases, QuickBBS
  20. (Hudson) messagebases and Squish messagebases.
  21.  
  22.  
  23.  
  24. EVOLUTION
  25.  
  26. The original MSGED was written by Jim Nutt and released to the
  27. public domain.  It worked on *.MSG and Quickbbs messagebases,
  28. at least by version 2.00, under DOS 16-bit and OS/2 16-bit.
  29. The last release Jim did before "disappearing" was 2.08 dos,
  30. which was 2.06 os/2.
  31.  
  32. MSGED/SQ was later created by John Dennis, who originally kept
  33. all his changes copyrighted, but later he then went and released 
  34. all his stuff to the public domain.  This version worked on 
  35. both *.MSG and Squish messagebases, and worked under 16-bit DOS 
  36. and 16-bit OS/2.  The last release from John was 2.2e, after 
  37. which he explicitly said he was no longer interested in maintaining 
  38. it.  The source was released in an archive called MSQ22SRC.LZH.
  39.  
  40. MSGED/SQ 2.2e was then modified by Paul Edwards to make it work
  41. with *.MSG and Squish under 16-bit DOS and 32-bit OS/2.  Plus
  42. a few bug fixes and enhancments.  The first version of this
  43. released was 3.00.  The last version released was MSGED/SQ 3.35.
  44.  
  45. The "MSGED" name was then retaken, starting with version 4.00.
  46. If Jim ever comes back, he is welcome to have the name back, but
  47. until then, this is by far the most actively developed strain
  48. of MSGED, so I thought it was better to be on the "main trunk".
  49. The main thing that MSGED 2.08 appeared to have that MSGED/SQ 
  50. 3.35 didn't, was quickbbs support, so I used the quickbbs code
  51. from MSGED 2.08 and modified it to work with MSGED/SQ 3.35.
  52.  
  53.  
  54.  
  55. EXECUTABLES
  56.  
  57. The main DOS executable is MSGED.EXE.  The main OS/2 executable
  58. is MSGEDP.EXE.  The Amigados executable is called msgedam.  The 
  59. Linux executable is called msgedunx.  The 32-bit DOS executable 
  60. is called msged32.  The 16-bit OS/2 version is not actually 
  61. compiled, as it is not expected that anyone actually wants it 
  62. (although maybe there are some Windows/NT users who want it - 
  63. unless someone requests it, it won't be coming).  Also it doesn't 
  64. work with MSGAPI.
  65.  
  66.  
  67.  
  68. MSGED32 EXECUTABLE
  69.  
  70. This 32-bit DOS-extended version of MSGED has been linked with 
  71. the PMODE/W DOS-extender.  You can FREQ this from 3:711/934 with
  72. name "PMW122.ZIP".  If you would rather use the DOS4GW dos-extender,
  73. which allows you to use disk space if you run out of memory, then
  74. FREQ "DOS4GW.ZIP" from 3:711/934, put DOS4GW.EXE in your path, set
  75. DOS4G=QUIET in your autoexec.bat, and run MSGED32 by going
  76. "DOS4GW MSGED32".
  77.  
  78.  
  79.  
  80. DOCUMENTATION
  81.  
  82. See MSGED.DOC for the documentation.  The documentation is not
  83. up-to-date.  Volunteers to do the work, please contact me.
  84.  
  85.  
  86.  
  87. OTHER FILES
  88.  
  89. There is a configuration file MSGED.CFG which you will probably
  90. need to make a fair few changes to to get MSGED up and running.
  91. Other files include MSGED.COL, MSGHELP.DAT, TEMPLATE.MSG.  For
  92. OS/2 users, there is a "MSGED.ICO" icon.
  93.  
  94.  
  95.  
  96. SOURCE
  97.  
  98. Full source code is included in the SRC subdirectory.  MSGED
  99. can be compiled using:
  100.  
  101. MAKEFILE.WAT - OS/2 makefile for Watcom
  102. MAKEFILE.IBM - OS/2 makefile for CSET
  103. MAKEFILE.EMX - OS/2 makefile for GNU/EMX
  104. MAKEFILE.BCC - OS/2 makefile for Borland
  105.  
  106. MAKEFILE.DOS - DOS makefile for Borland
  107. MAKEFILE.TCC - DOS makefile for Turbo C++
  108. MAKEFILE.W16 - DOS makefile for Watcom 16-bit
  109. MAKEFILE.MSC - DOS makefile for Microsoft C
  110. PACIFIC.PRJ  - DOS makefile for Pacific C (needs PACIFIC.PAT)
  111.  
  112. MAKEFILE.W32 - DOS-extended makefile for Watcom 32-bit
  113.  
  114. MAKEFILE.UNX - Linux makefile for dmake (with "-B") using gcc
  115.  
  116. MAKEFILE.SAS - Amiga makefile for SAS/C 6.55
  117.  
  118. MAKEFILE.MSO - OS/2 16-bit Microsoft C compile
  119.  
  120. MAKEFILE.ANS - Watcom, OS/2, 32-bit, ANSI screens
  121.  
  122. MAKEFILE.PDP - EMX, OS/2, 32-bit, PDPCLIB, not yet working
  123.  
  124. MAKEFILE.WNT - Watcom, Windows/NT, 32-bit, not yet working
  125.  
  126. As shipped, the OS/2 version has been compiled with Watcom 10.0
  127. 32-bit compiler with full optimization, the DOS version has
  128. been compiled with Watcom 10.0 DOS with full optimization.  The
  129. Linux version has been compiled with gcc with optimization on, and
  130. the Amigados version has been compiled with SAS/C with optimization
  131. on.  The DOS 32-bit version has been compiled with Watcom C with
  132. optimization on.
  133.  
  134. Both the DOS and OS/2 executables have been statically linked 
  135. with MSGAPI38, which is a modification of the original MSGAPI0.
  136. You can FREQ this from 3:711/934 as MSGAPI38.*.  The date of
  137. the version used to compile MSGED is 1996-07-24.  Squish messagebase
  138. support does not exist for the Linux and Amigados versions, which
  139. isn't any real problem, since those platforms don't use that 
  140. messagebase format anyway.  Be warned that the QuickBBS format
  141. messagebase may change on Linux and Amigados environments, so I
  142. wouldn't get too attached to it, use *.MSG for now instead.
  143.  
  144.  
  145.  
  146. COPYRIGHT
  147.  
  148. All of the source code in this archive is public domain.
  149. However, to access Squish messagebases requires use of Scott
  150. Dudley's MSGAPI routines, which are copyrighted by him, and
  151. linked in to the executable.  This is allowed according to
  152. the license that the MSGAPI is distributed under.  If someone
  153. has some public domain C code to access the Squish messagebases,
  154. please let me know so that I can use that in MSGED.  Also, the
  155. PMODE/W 32-bit DOS-extender is copyrighted, as indeed is the
  156. relevant compiler's C runtime library.
  157.  
  158.  
  159.  
  160. SUPPORT
  161.  
  162. You can reach the current author, Paul Edwards at 3:711/934@fidonet.
  163. However, it would be preferable if you posted your questions in
  164. MSGED_ECHO in a message to "All" so that others can help answer your
  165. question.
  166.  
  167. What I would REALLY like is for you to get a local C expert to find 
  168. the bug and just send me the bug fix so that I can incorporate it 
  169. into the next release.  This avoids the headache of me trying to
  170. reproduce your problem here.  Note that since there are FREE compilers
  171. available to compile MSGED, namely EMX for OS/2, Pacific C for DOS,
  172. gcc for Linux, and also (untested) gcc for Amigados, there is no
  173. excuse not to do the work yourself instead of piling it on to me.
  174. The whole idea of free software is you are meant to contribute to
  175. it.
  176.  
  177. As for enhancement requests, please send C source code that 
  178. implements the enhancement (and explicitly state that the code
  179. is public domain, too).  I have a long list of enhancements
  180. which I personally want, and when I have finished all of them,
  181. and all of my other public domain projects, I will start
  182. soliciting other enhancement requests.  Hell might freeze over
  183. before that time though.  If you don't know how to program in C,
  184. then get one of those 14 year-old's that spends most of their
  185. spare time hacking into the US DOD computers to spend 10 minutes
  186. of their expertise on your MSGED enhancement.  It takes me DAYS
  187. to add enhancements.
  188.  
  189. By the way, the best way to send me changes is by using a utility
  190. called "DIFF".  This is a "standard unix" command which is
  191. available for OS/2, and I presume also DOS.  I actually use CVS
  192. (in conjunction with RCS) to do the diffs.  I know all of this
  193. stuff is available for OS/2, and I think it is also available for
  194. DOS.  The stuff is available for FREQ from 3:711/934.  Anyway,
  195. if you have changed say msged.c, then you can go:
  196. diff --context \old\msged.c \new\msged.c and get just a list of
  197. changes that you have made.  I prefer to get all the differences
  198. in one file, so that I can feed it directly into another